Inside Macintosh: Mac OS 8 Toolbox Reference /

Chapter 2 - Control Manager Reference / Control Manager Functions

Embedding Controls /

AutoEmbedControl

NEW WITH THE APPEARANCE MANAGER

Automatically embeds a control in the smallest appropriate embedder control.

pascal OSErr AutoEmbedControl (
                     ControlHandle inControl,
                     WindowPtr inWindow);

inControl

On input, a handle to a control to be embedded.

inWindow

On input, a pointer to the window in which you want to embed the control.

function result

A result code; see "Result Codes". The result code errControlIsNotEmbedder indicates that embedding is not enabled for that window. The result code errItemNotControl indicates that the dialog item that you wish to embed is not a control (not in an embedding hierarchy).

DISCUSSION

The Dialog Manager uses AutoEmbedControl to position dialog items in an embedding hierarchy based on both visual containment and the item list resource order. For information on embedding hierarchies in dialog and alert boxes, see "Embedding Controls".

SEE ALSO

"Appearance Manager Gestalt Selector Constants".

EmbedControl.